home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 051-075 / disk_060 / med / med.doc < prev    next >
Text File  |  1992-05-06  |  8KB  |  274 lines

  1. Article 2024 of comp.sys.amiga:
  2. Path: mcdsun!noao!hao!hplabs!sdcrdcf!ucla-cs!rutgers!seismo!mcvax!inria!rouaix
  3. From: rouaix@inria.UUCP (Francois Rouaix)
  4. Newsgroups: comp.sys.amiga
  5. Subject: Another Text editor--
  6. Message-ID: <384@inria.UUCP>
  7. Date: 9 Feb 87 20:11:32 GMT
  8. Organization: INRIA, Rocquencourt. France
  9. Lines: 261
  10.  
  11. Preliminary: this product is named Med, but it is not related to Matt Dillon's
  12. editor MED. We are sorry for this confusion, but since this editor has been
  13. sold in France for six months, it is not possible to rename it for 
  14. international distribution.
  15.  
  16.  
  17.  
  18.       DOCUMENTATION FOR THE VERSION 2.1 OF TEXT EDITOR MED
  19.       ======================================================
  20.  
  21.  
  22. Med is a text editor that I wrote especially for the Amiga. I wanted to use
  23. the features of the Amiga to make it as user-friendly as possible.
  24. So my program works with the mouse and the menus (and many other Intuition
  25. features).
  26. You can edit up to 36 texts simultaneously. In this documentation I will try
  27. to explain some of the special features of Med.
  28.  
  29. I ask you to be indulgent with my english which is very poor.
  30.  
  31.  
  32. Use of the Mouse:
  33. =================
  34.  
  35.    Move the cursor.
  36.    Move the lift. (scroll-bar)
  37.    Selecting text:
  38.       Hold down the left button and move the mouse. Release the button
  39.       at the end of the region you want to select.
  40.       The selected text is highlighted.
  41.       You may also use an 'extended-select' mode
  42.          1. Hold down the left mouse button.
  43.          2. Press the Escape key.
  44.          3. Release the left mouse button.
  45.          4. Use the lift (as many times as you need).
  46.          5. Click in the window. The visible selected text is highlighted.
  47.          5. You can return in 2.
  48.  
  49.       The mouse is also used for all the usual Amiga interface.
  50.  
  51.  
  52.  
  53. The menus:
  54. ==========
  55.  
  56.    There are 28 of them.
  57.    ONLY THE MENUS WHICH DON'T HAVE AN EVIDENT MEANING ARE
  58.    DESCRIBED HERE.
  59.  
  60. Menu File/Quit:
  61.    Med asks you if you are really sure that you don't want to save the file
  62.    you have modified. It gives you the name of this file.
  63.  
  64. Menu Edition/Special/Path:
  65.    You can give a string which will be put in front of all the filenames.
  66.    It is very useful when you work on files in a directory which is not
  67.    the current directory, allowing you not to type the entire path each
  68.    time you open (or save) a file in this directory.
  69.  
  70. Menu Edition/Special/Execute:
  71.    You can execute a CLI command just as you would from the CLI.
  72.    Med is stopped since this command runs.
  73.  
  74. Menu Edition/Special/NewCli:
  75.    You can create a new CLI.
  76.  
  77. Menu Edition/Special/Script:
  78.    Use this menu to load several files with an unique command.
  79.    A requester appears and asks you for a filename.
  80.    This file will be used as a description file.
  81.    Each line of this file will be understood by Med as the description of
  82.    a file to load.
  83.    The syntax you must use is:
  84.             filename size comment
  85.      filename: the file Med should load. If there is a path, it is used.
  86.      size: the buffer size that Med should allocate . (optionnal)
  87.      comment: for the user, may be empty.
  88.  
  89.          Between the fields you must put at least one space.
  90.          The lines which begin with * are comments.
  91.  
  92.             example of a script file
  93. C-DEVEL:one.window.c   20
  94. C-DEVEL:essai.c        10000
  95. * this a comment
  96. C-DEVEL:toto.c         1
  97. tob.asm                20000
  98.  
  99.          You can use this feature directly from the command line with the
  100.          syntax :
  101.             Med -sfile
  102.                file must be a script file.
  103.  
  104. Menu Edition/Special/Save Table
  105. Menu Edition/Special/Load Table
  106.  
  107.     These 2 menus deal with the conversion table that Med use when it loads
  108.     a file. All the character it reads are changed according to this table.
  109.     Usually a character is changed into itself.
  110.     The default table is the identity.
  111.     The menu Load Table can be used to change it.
  112.     A requester appears asking you for a filename.
  113.     In this file you must put lines of this type:
  114.          iv fv comment
  115.            where
  116.             iv  :  initial value of the character in hexadecimal
  117.             fv  :  final value of the character in hexadecimal
  118.             comment : field reserved to the user.
  119.  
  120.     These fields must be separed by one (or more) space.
  121.     If one value iv appears several times the last value is used.
  122.     If any value doesn't appear Med keeps the default value .
  123.     The lines which begin with * are comment.
  124.  
  125.     The menu 'Save Table' may be used to create a file which is the map
  126.     of the conversion table  and  has the same format.
  127.  
  128.     This feature is designed to allow you to work on files coming from
  129.     an another machine or containing special characters.
  130.  
  131. Example of a table file:
  132.  
  133. 0 20    0 are changed into space.
  134. D A     ^M becomes ^J
  135. * comment
  136. 41 42   A --> B (!!!).
  137.  
  138.  
  139. Edition/Special/Without Spaces:
  140.    This defines a parameter for the way Med writes a file on the disk.
  141.    When the name of menu is 'Without Space', the spaces Med finds at
  142.    the end of a line are not written.
  143.    When the name is 'With Space' they are.
  144.    The default mode is 'Without Space'.
  145.  
  146. Window/Open
  147.    Open a new window.
  148.    It is possible only if there are more loaded texts than opened windows.
  149.  
  150.  
  151. Window/Close
  152.    Close the active window.
  153.    It won't work if the active window is the only window.
  154.  
  155. Window/Info
  156.    Give the number of windows opened by Med.
  157.  
  158.  
  159. Text/....
  160.  
  161.    It shows all the files being currently edited.
  162.    You may edit up to 36 texts simultaneously.
  163.    If a file has been modified, its name will appear in a box when selected,
  164.    else it will be highlighted.
  165.  
  166.  
  167.  
  168. The soft keys.
  169. =============
  170.  
  171. F1
  172.    The cursor toggles between beginning and end of line. The cursor will stay
  173. on the last visible colon if there are characters at his right. This is a sim-
  174. ple way to tell which line is more than 80 characters long.
  175.  
  176. F2
  177.    Creates a new line under the current one.
  178.  
  179. F3
  180.    It is a parenthesis and brace verificator. You point the cursor on a
  181.    parenthesis or a brace, press F3 and the cursor goes to the matching
  182.    element if it exists. Else, the screen flashes.
  183.  
  184. F4
  185. F5
  186.    Moves the text up and down by a screen unit.
  187.  
  188.  
  189. F6
  190.    Repeats commands which are among the menus. Possible commands are Find,
  191.    Replace,Go to Line,Copy in a File.
  192.  
  193. F7
  194.    Gives back the last part of the text which has been deleted by a cut
  195.    or by F10.
  196.  
  197. F8
  198.    Switch upper-case and lower-case letters.
  199.  
  200. F9
  201.    Put the cursor on the next tabulation.
  202.  
  203. F10
  204.    Delete the line where the cursor is.
  205.  
  206.  
  207. The control keys:
  208. ================
  209.  
  210.    Some are implemented to help Ed users:
  211.  
  212.          ^a  == F2
  213.          ^b  == F10
  214.          ^f  == F8
  215.  
  216. Moving in the text:
  217. =================
  218.  
  219.    You may use the cursor keys.
  220.    Tab indents the line (shifting the text to the right).
  221.    Shift Tab just moves the cursor to the right.
  222.  
  223. Some Basics:
  224. =================
  225.  
  226.    When you select text with the mouse, your next action specifies the use
  227.    of this text.
  228.    If Med can't have the memory it needs, it shows a requester or it
  229.    does a screen flash.
  230.  
  231.    There is no limitation on the length of the lines so you may always
  232.    put some character in the line BUT a character is inserted exactly
  233.    where the cursor is.
  234.  
  235.    Med never accepts non-visible characters.
  236.  
  237.    The end of line is LineFeed (standard for the Amiga).
  238.  
  239.    The tabulation characters are always changed in spaces.
  240.  
  241.    When you load or you save a file, Med doesn't do any back-up.
  242.    This saves room on disks, while the user generally makes his own back-up
  243.    on another disk.
  244.  
  245.  
  246.  
  247. The command line:
  248. =================
  249.  
  250.    med [file [size]]
  251.       file :file which should  be loaded by med.
  252.       size :buffer size Med will allocate for the file.
  253.             You may give it in bytes or in kilo-bytes.
  254.             Default is 30K.
  255.  
  256.    med -sfile
  257.       You use it to load several files with only one command (see the ex-
  258.       planation above).
  259.  
  260.  
  261.  
  262. I give my thanks to Francois Rouaix who helped me to write this text in
  263. english and to test the editor and to Gerald Hewes who always pushes me to
  264. define more useful commands.
  265.  
  266.                                  Paris the 01/27/87
  267.                                           Regis Vaillant.
  268.  
  269.  
  270. PS: please email any bugs, comments and suggestions to 
  271.     ...mcvax!inria!rouaix
  272.  
  273.  
  274.